package org.zwy.gradetrack.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import org.zwy.gradetrack.entity.OperationLog;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 操作日志服务接口
 */
public interface OperationLogService extends IService<OperationLog> {
    
    /**
     * 分页查询操作日志
     *
     * @param page 分页参数
     * @param operationModule 操作模块
     * @param operationType 操作类型
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 分页结果
     */
    Page<OperationLog> pageLogs(Page<OperationLog> page, String operationModule, String operationType,
                              LocalDateTime startTime, LocalDateTime endTime);
    
    /**
     * 创建操作日志
     *
     * @param log 操作日志
     * @return 是否成功
     */
    boolean createLog(OperationLog log);
    
    /**
     * 批量创建操作日志
     *
     * @param logs 操作日志列表
     * @return 是否成功
     */
    boolean batchCreateLogs(List<OperationLog> logs);
    
    /**
     * 根据用户ID查询操作日志
     *
     * @param userId 用户ID
     * @return 操作日志列表
     */
    List<OperationLog> getLogsByUserId(Long userId);
    
    /**
     * 根据操作类型查询操作日志
     *
     * @param operationType 操作类型
     * @return 操作日志列表
     */
    List<OperationLog> getLogsByOperationType(String operationType);
    
    /**
     * 根据时间范围查询操作日志
     *
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 操作日志列表
     */
    List<OperationLog> getLogsByTimeRange(LocalDateTime startTime, LocalDateTime endTime);
    
    /**
     * 清理指定时间之前的操作日志
     *
     * @param time 时间点
     * @return 是否成功
     */
    boolean cleanLogsBefore(LocalDateTime time);
} 